home *** CD-ROM | disk | FTP | other *** search
/ JCSM Shareware Collection 1993 November / JCSM Shareware Collection - 1993-11.iso / cl980 / hshl451j.lzh / READ.ME < prev   
Text File  |  1992-09-12  |  23KB  |  463 lines
  1.       HyperShell Release 4.5 - September 1992
  2.       ---------------------------------------
  3.  
  4.       HyperShell  is a general purpose hypertext control system. Standard
  5.       hypertext features provided include a text frame based presentation
  6.       style with highlighted references permitting  navigation  to  other
  7.       frames  in  the same or another file, to popup notes which can have
  8.       further  references,  and  allowing  backtracking  through  visited
  9.       frames, and marking of frames and references for later perusal. The
  10.       program also supports graphic screen displays with nested selection
  11.       zones,  using  the  common BLOAD format screen files for monochrome
  12.       images and Microsoft Paintbrush (.PCX) files for  colour  and  some
  13.       monochrome  images.  CGA,EGA,VGA and Hercules graphics adaptors are
  14.       supported.
  15.  
  16.       Special features offered include popup  menus,  paged  displays  of
  17.       menus  or text files, DOS management facilities, scripting language
  18.       with programming  capability,  variables,  macros,  formfill  input
  19.       fields  and numerous features such as program invocation permitting
  20.       the use of HyperShell for menuing systems, help  systems,  computer
  21.       aided  instruction,  simple  databases,  DOS directory managers and
  22.       numerous other applications. Alternative hypertext  structures  are
  23.       also  supported,  permitting adhoc creation of supporting text. The
  24.       hypertext files and supporting files can be compressed and  can  be
  25.       directly accessed in compressed form.
  26.  
  27.       HyperShell  has  been  designed  to  be  fast, small, and powerful,
  28.       supporting files larger than available memory  whilst  occupying  a
  29.       fixed  amount  of  memory itself (128k currently) so that it can be
  30.       used for controlling other applications. It is designed to  run  on
  31.       the  widest  range of equipment, and the components do not need any
  32.       more than a minimal 256k twin floppy mono system (or just a  single
  33.       floppy  system  for the reader component to be used), although they
  34.       will benefit from the use of colour, a mouse, and a hard disk.  The
  35.       system   is   very  configurable,  including  colour  schemes,  key
  36.       mappings, all text strings, control menu and presentation 'look and
  37.       feel'. The supporting files are of textual content, permitting easy
  38.       production and maintenance.
  39.  
  40.       The   system   provided  as  shareware  is  the  full  release
  41.       incorporating   the   runtime   control   program,    introduction,
  42.       demonstration,   and   reference   hyperdocuments,   and  the  full
  43.       development system, including a set of cooperating authoring  tools
  44.       and  full  documentation  on disk.  The tools include an integrated
  45.       development environment for producing and  maintaining  hyperfiles,
  46.       as  well  as  for  use  as a freetext database system, an extensive
  47.       syntax and  consistency  checking  program,  a  hyperfile  printout
  48.       utility, compression and expansion utilities and TSR screen capture
  49.       and  graphic  preparation  facilities.  Also  provided  is  a popup
  50.       context sensitive hypertext  system  which  utilises  a  subset  of
  51.       HyperShell syntax, and is ideal for help systems and similar uses.
  52.  
  53.       Documentation includes a full authoring guide and a quick reference
  54.       guide.  Also there is a hypertext reference guide and a popup quick
  55.       reference guide.
  56.  
  57.       RUNNING HYPERSHELL
  58.       ==================
  59.       ************************ IMPORTANT ****************************
  60.       * MAKE A COPY OF THE DISTRIBUTION DISKS & WORK USING THE COPY *
  61.       ***************************************************************
  62.  
  63.       The disks contain a number  of  archives,  each  of  which  can  be
  64.       extracted to a hard disk. Most archives may also be extracted to a
  65.       floppy disk (the documentation requires at least a 720k disk).
  66.  
  67.       HMAINSFX.EXE        Main programs and demonstrations
  68.       HYPOPSFX.EXE        HyperShell popup subset plus utilities
  69.       HDEV1SFX.EXE        Development tools etc. part1
  70.       HDEV2SFX.EXE        Development tools etc. part2
  71.       HDOCSFX.EXE         Documentation files (shareware version only)
  72.       HSRESSFX.EXE        Shareware version of HSRES
  73.       PGRESSFX.EXE        Shareware version of PROGRESS
  74.  
  75.       There are install batch files on each 360k distribution disk.
  76.       1. install
  77.       2. install2
  78.       3. install3
  79.  
  80.       On a 720k distribution disk, there will be two install files
  81.       to run on the first, and one on the second:-
  82.       1. install     install2
  83.       2. install3
  84.  
  85.       Type 'install' and follow the instructions.
  86.  
  87.       RUNNING THE DEMONSTRATIONS
  88.       ==========================
  89.  
  90.       Before  you run the demonstrations, you must check that the COMSPEC
  91.       environment variable points to a  location  where  the  COMMAND.COM
  92.       program  is  held, and the PATH environment variable must be set up
  93.       to include the drive/directory containing  the  programs,  for  the
  94.       HOME  hyperfile  and the DOS EXIT to work, but are not essential to
  95.       try out HS against a hyperfile directly.
  96.  
  97.       Using the files extracted from the HMAIN archive, adjust contrast
  98.       on your monitor  to  show colours or intensity levels correctly,
  99.       and type :-
  100.  
  101.         HS
  102.  
  103.       This will present a menu of options.  To  start  with,  select  the
  104.       Introduction   option   to   display  the  HyperShell  introductory
  105.       hyperfile to get you started on how to use  HyperShell.  Hyperfiles
  106.       with an extension of .HYP can be run using the command
  107.  
  108.         HS filename
  109.  
  110.       Some of the examples require extra space to save changes or edits.
  111.       If you are using a floppy system,
  112.       copy the files to a fresh floppy before use.
  113.  
  114.       If  you  have a Microsoft compatible mouse, the system will use the
  115.       mouse driver directly, otherwise a 'mouse emulation' mode  will  be
  116.       used  whereby  the  cursor  keys are used to position the selection
  117.       cursor, but this will not allow you to use  a  mouse  pointer  with
  118.       graphic displays.
  119.  
  120.       IMPORTANT:  Some software, such as the GEM desktop environment, may
  121.       leave certain mouse drivers in an antisocial state, such  that  any
  122.       program  attempting  to  use  the  mouse  interface  will  hang the
  123.       computer, requiring a hard reset.  If  this  happens  when  running
  124.       HyperShell,  try  rebooting before running the program, and if this
  125.       fails, try using the -m command line flag, or  not  installing  the
  126.       mouse driver.
  127.  
  128.       MONOCHROME MONITORS ON EGA / VGA:  On a VGA system, switch the  VGA
  129.       card into colour mode to take advantage of the grey scale outputs.
  130.       On a mono EGA system, you will experience problems with certain
  131.       colour schemes - it is suggested that you run the system with the
  132.       following command format:-
  133.  
  134.         hs -h hs
  135.  
  136.       SHAREWARE DETAILS
  137.       =================
  138.  
  139.       HyperShell is a trademark of Text Technology.
  140.  
  141.       The   HyperShell  system,  including  supporting  utilities,  is  a
  142.       shareware product.  This means the following:-
  143.  
  144.       HyperShell Copyright (c) 1988,1989,1990,1991,1992 Text Technology
  145.                        All Rights Reserved
  146.  
  147.       HyperShell  IS  NOT  FREE. It is a commercial product for which you
  148.       must pay if you are to use it, and  is  subject  to  the  copyright
  149.       laws.
  150.  
  151.       You  are  encouraged  to  make  copies  of the HyperShell shareware
  152.       distribution, without any alterations to the files in it, and  give
  153.       these  to  others  for  evaluation.  This  READ.ME file must not be
  154.       altered and must accompany all copies. The system  may  be  offered
  155.       for   download   via  Bulletin  Boards,  and  may  be  offered  for
  156.       distribution by shareware distributors, provided unduly high  rates
  157.       are not charged for such distribution.
  158.  
  159.       You are permitted to make unlimited use of  the  HyperShell  reader
  160.       program  (HS.EXE)  with  any  hyperfiles  supplied  to you, without
  161.       further registration, provided you do  not  alter  the  content  of
  162.       these  files.  A contribution would be welcome if you  feel you are
  163.       gaining benefit from the system in using it this way.
  164.  
  165.       You  are  permitted  to  evaluate the system for producing your own
  166.       hyperfiles for a period not exceeding three (3) calendar months. If
  167.       you produce your own  hyperfiles  for  your  own  use  beyond  that
  168.       period,  you are required to pay for a HyperShell personal licence.
  169.       A  personal  licence  allows  one  person  to  use  HyperShell  for
  170.       producing  hyperfiles for his own use and for distribution with the
  171.       reader program (HS.EXE or HL.EXE) WITHOUT CHARGE  to  others,  with
  172.       the exception that where this is done in a commercial environment a
  173.       developers  licence  is  payable  (see  below).   Also the personal
  174.       licence allows the sale of  your  own  material,  with  the  reader
  175.       program  (HS.EXE  or  HL.EXE), AS SHAREWARE over bulletin boards or
  176.       via shareware distribution channels, PROVIDED it is made  clear  to
  177.       the  purchaser that the material must not be altered, AND a copy of
  178.       the material as distributed is  sent  to  Text  Technology  on  the
  179.       understanding  that  unaltered  copies  may  be  sent to interested
  180.       parties or further distributed.
  181.  
  182.       If you produce hyperfiles for use by others, where a charge is made
  183.       for  the  material  or  for your services in the production of that
  184.       material, you are required to pay for a  developers  licence.  This
  185.       applies  whether  the  material  forms part of a package, or is the
  186.       whole package.  The  developers  licence  entitles  one  person  to
  187.       produce  hyperfiles for any number of 'end' users to read using the
  188.       HS.EXE or HL.EXE reader program, and/or to print using  the  HP.EXE
  189.       formatted  print  program. Note that a licence is required for EACH
  190.       person developing such material.  Site licence terms are  available
  191.       on  request. Corporate licence rates are available if more than one
  192.       person is to produce hyperfiles.   In  certain  cases,  subject  to
  193.       specific  agreement  with Text Technology, applications built using
  194.       the Integrated Environment features may be  distributed  under  the
  195.       developers  licence  at  no  additional  charge.   Text  Technology
  196.       reserves the right to apply a runtime royalty rate in other  cases,
  197.       which is subject to negotiation on a per case basis.
  198.  
  199.       Under the personal or developers licence terms, you may  provide  a
  200.       copy  of the HyperShell runtime components (HS.EXE, HL.EXE,  HP.EXE
  201.       and HYPOP.EXE) with any material that you distribute to others. You
  202.       must  also  provide  an  acknowledgement, visible on screen  or  in
  203.       printed documentation, indicating that HyperShell has been used and
  204.       giving the name and address of Text Technology.
  205.  
  206.       If  HyperShell  is to be used by others within an academic or other
  207.       non profit making establishment, and no charge is to be levied  for
  208.       the  use  of  the  system,  a  reduced rate is applicable, which is
  209.       available on  application.  Also  special  academic  licences   are
  210.       available  for teaching or classwork purposes. If such use is to be
  211.       made in a commercial establishment, the full developers licence  is
  212.       applicable for each person producing material.
  213.  
  214.       The HyPop program is provided as part of the HyperShell system, but
  215.       may  be  separately  licenced  if  you  just require a simple popup
  216.       hypertext system. The development licence for this is  required  if
  217.       you want to distribute the system with your own software.
  218.  
  219.       If you decide not to register after the evaluation period you  must
  220.       destroy  all  copies  of any hyperfiles which you have used in that
  221.       time. YOU MUST NOT GIVE COPIES OF ANY  HYPERFILES  YOU  PRODUCE  TO
  222.       ANYONE, WITHOUT FIRST OBTAINING A SUITABLE LICENCE.
  223.  
  224.       THIS SOFTWARE IS PROVIDED 'AS IS' AND TEXT TECHNOLOGY DISCLAIMS ALL
  225.       WARRANTIES  RELATING TO THESE SOFTWARE PRODUCTS, WHETHER EXPRESS OR
  226.       IMPLIED, INCLUDING BUT NOT LIMITED TO  ANY  IMPLIED  WARRANTIES  OF
  227.       MERCHANTABILITY  AND FITNESS FOR A PARTICULAR PURPOSE, AND ALL SUCH
  228.       WARRANTIES ARE EXPRESSLY AND SPECIFICALLY DISCLAIMED. NEITHER  TEXT
  229.       TECHNOLOGY  NOR  ITS  AGENTS  SHALL  BE  LIABLE  FOR  ANY INDIRECT,
  230.       CONSEQUENTIAL, OR INCIDENTAL DAMAGES ARISING  OUT  OF  THE  USE  OR
  231.       INABILITY  TO  USE  SUCH  SOFTWARE EVEN IF TEXT TECHNOLOGY HAS BEEN
  232.       ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR CLAIMS. IN  NO  EVENT
  233.       SHALL  TEXT  TECHNOLOGY'S LIABILITY FOR ANY DAMAGES EVER EXCEED THE
  234.       PRICE PAID FOR THE LICENCE TO USE THE SOFTWARE, REGARDLESS  OF  THE
  235.       FORM  OF  CLAIM. THE PERSON USING THE SOFTWARE BEARS ALL RISK AS TO
  236.       THE QUALITY AND PERFORMANCE OF THE SOFTWARE.
  237.  
  238.       ASP Statement
  239.       =============
  240.  
  241.       Text Technology is a member of the ASP.
  242.  
  243.                               _______
  244.                          ____|__     |               (tm)
  245.                       --|       |    |-------------------
  246.                         |   ____|__  |  Association of
  247.                         |  |       |_|  Shareware
  248.                         |__|   o   |    Professionals
  249.                       -----|   |   |---------------------
  250.                            |___|___|    MEMBER
  251.  
  252.       "This program is produced by a member of the Association
  253.        of Shareware Professionals (ASP).  ASP wants to make sure
  254.        that the shareware principle works for you. If you are
  255.        unable to resolve a shareware-related problem with an ASP
  256.        member by contacting the member directly, ASP may be able
  257.        to help. The ASP Ombudsman can help you resolve a dispute
  258.        or problem with an ASP member, but does not provide
  259.        technical support for members' products. Please write to
  260.        the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442, U.S.A.
  261.        or send a CompuServe message via CompuServe Mail to ASP
  262.        Ombudsman 70007,3536."
  263.  
  264.       REGISTRATION
  265.       ============
  266.  
  267.       The  following scale of charges are applicable to version 4.5 only,
  268.       and  supersedes  all  previous  scales  with  immediate effect. The
  269.       quoted  prices are subject to change without further notice. If you
  270.       register after 1992, please check prices first (or add 20% for each
  271.       year).
  272.  
  273.       HyPop/HCX only - single user licence - 10 pounds
  274.  
  275.       HyPop/HCX only - Developers licence - 30 pounds
  276.  
  277.       HyperShell Personal licence - 50 pounds
  278.       (now includes HSRES registered version)
  279.  
  280.       HyperShell Developers licence - 100  pounds  (no  runtime  per-copy
  281.       royalties) (now includes HSRES registered version)
  282.  
  283.       PGRES program, registered through Text Technology - 30 pounds
  284.  
  285.       HyperDex database system (includes HyperShell licence)
  286.         Evaluation system (readonly access to databases) - 10 pounds
  287.         Personal Licence                                 - 80 pounds
  288.         Developers Licence                               - 190 pounds
  289.  
  290.       Professional support utilities package
  291.       - a combination of utilities including PGRES,
  292.         professional copy protection system, HyperShell Hyperfile to
  293.         Windows-3 .HLP conversion assistance (requires Microsoft help
  294.         compiler) and other products normally available separately
  295.            - at a special bundled price - apply for details
  296.  
  297.       Upgrades  of  HyperShell  licences  are  chargeable  at  difference
  298.       between price paid and current price of required licence.
  299.  
  300.       Special educational rates available on application.
  301.  
  302.       Personal  and  Developers registration for the full system includes
  303.       the latest copy of version 4 together  with  printed  documentation
  304.       and  low  cost  updates  to  this version.  It also includes postal
  305.       support for problems of use and for bug  reports,  until  the  next
  306.       major  version  release.   Telephone  support  is only available at
  307.       certain times.  We do  not  provide  a  'hotline'  service,  but  a
  308.       reasonable  attempt  will  be  made  to  answer problems as soon as
  309.       possible.
  310.  
  311.       Registration  is  a  one  off  charge,  and  entitles  you  to  use
  312.       HyperShell under the terms of your licence for as long as you like.
  313.  
  314.       Additional  support,  for  instance in the design and production of
  315.       hyperfiles, is chargeable on a time and materials basis at mutually
  316.       agreed rates.
  317.  
  318.       Custom modifications will  be  charged  on  a  sliding  scale  from
  319.       nothing  for  a  generally  useful  feature  up  to  full  time and
  320.       expenses for a special purpose modification.
  321.  
  322.       Payment by cheque or  postal order in pounds sterling is preferred.
  323.       Payment in a currency other than pounds sterling  should  have  the
  324.       equivalent  of  6  pounds added to cover currency conversion costs.
  325.       We  can  also  accept orders by post or telephone on certain credit
  326.       cards (Access, Visa, Mastercard,  Eurocard)  subject  to  the usual
  327.       rules,  and if you  wish to order this way please state the type of
  328.       card,  the  card  number  and  the expiry date,  as well as a phone
  329.       number where you can be contacted.  Credit card sales are in pounds
  330.       sterling (this will be handled automatically).
  331.  
  332.       Postal charges are as follows:-
  333.            British Isles ................... 2 pounds
  334.            Europe .......................... 5 pounds
  335.            Outside Europe .................. 10 pounds
  336.  
  337.       Please note: EXTRA IMPORT DUTY MAY BE PAYABLE BY YOU ON RECEIPT.
  338.  
  339.       However, registration and documentation may be provided by a  local
  340.       distributor at better rates, so check first.
  341.  
  342.       There  are  no guarantees with the supplied product, other than for
  343.       the replacement of defective media. Registration  means  acceptance
  344.       of  the  product  and any money paid will not be refundable, unless
  345.       you have registered without seeing the product, in which  case  you
  346.       may  return  the complete package in a saleable condition within 30
  347.       days for a refund of your licence fee less costs.
  348.  
  349.       Bug  reports and suggestions for improvements are welcomed from all
  350.       users,  including  unregistered  users  evaluating   the   product.
  351.       All  bug  reports  and  problems  from  registered  users  will  be
  352.       responded to.  All  problems  should  be  posted  to  the  provided
  353.       address  of  Text Technology or the agent you have registered with.
  354.       Full details of problems should be included, along with any related
  355.       hyperfile if this would be of assistance in solving a problem.  Bug
  356.       reports  should  indicate  the  full  circumstances  of  the   bug,
  357.       including   the   machine   type,  monitor  type, the  memory size,
  358.       the  version  of  MSDOS  (or  DRDOS), details of resident programs,
  359.       the version of HyperShell or the component exhibiting the  problem,
  360.       and any other relevant information.
  361.  
  362.       ---- GREAT BRITAIN and PLACES NOT COVERED BY AGENTS BELOW ----
  363.  
  364.       The following address should be used for registration  and  support
  365.       in  the  United  Kingdom, parts of Europe not covered by agents listed
  366.       below, and parts of the world not covered by the agents listed below:-
  367.  
  368.       Nick Taylor
  369.          66 Kennedy Avenue
  370.          Macclesfield
  371.          Cheshire
  372.          England
  373.          SK10 3DE
  374.  
  375.       Enquiries and phone orders: 0625 431357 after 6 P.M. GMT/BST
  376.       or Weekends.
  377.  
  378.       Cheques should be made payable to N.G.Taylor.
  379.  
  380.       ---- DENMARK ----
  381.       In Denmark, please contact the following agent:-
  382.  
  383.       Werner Knudsen
  384.         Creative Text
  385.         Tulipanvej 5
  386.         DK-2600 Glostrup
  387.         Denmark
  388.  
  389.       ---- SPAIN and PORTUGAL ----
  390.  
  391.       Carlos Pintor
  392.         Libro Informatico Tecnico, S.L.
  393.         C/. Almarza, 11
  394.         28033 Madrid
  395.  
  396.         Telefs. (91) 302 7314   -   766 17 43
  397.  
  398.       ---- ITALY ----
  399.       In Italy, please contact the following agent:-
  400.         
  401.       Richard Brown
  402.         Studio Centro
  403.     Via Resuttana 367
  404.     90100 Palermo
  405.         Italy
  406.  
  407.         Tel: 091-516443
  408.         Fax: 091-518895
  409.  
  410.         HyperShell BBS 090-380607  (7-1-0)
  411.  
  412.       ---- GERMANY, AUSTRIA and SWITZERLAND ----
  413.  
  414.       Mayer Helmut
  415.         3262 WANG No. 41
  416.         AUSTRIA
  417.  
  418.       ---- AUSTRALASIA and MALAYSIA ----
  419.  
  420.       In Australasia and Malaysia, please contact the following agent for
  421.       details of local registration.
  422.  
  423.       Heinz Dreher
  424.         Hyperware Research Laboratory
  425.         School of Information Systems
  426.         Curtin University of Technology
  427.         GPO Box U1987
  428.         Perth 6001
  429.         Western Australia
  430.  
  431.         Enquiries: (09) 351 2000
  432.         Fax:       (09) 351 2255
  433.  
  434.       ---- ORDERING ----
  435.  
  436.       When ordering, please state which version you have.  Also it  would
  437.       be  useful  if  you  could  give  an  indication  of  what  type of
  438.       application  you  are  using  HyperShell  for.  Also  please  state
  439.       whether  you  want  the  system  on  5.25" 360k or 3.5" 720k disks.
  440.       Also whether you would prefer high density disks.
  441.  
  442.       (Arrangements for ordering via agents will differ - please refer to
  443.       agent for details).
  444.  
  445.       If  you  evaluate  HyperShell  and  find  it  unsuitable  for  your
  446.       requirements,  please  consider  sending  a  copy of any evaluation
  447.       report you produce.
  448.  
  449.       I hope you  will  enjoy  HyperShell  as  much  as  I  have  enjoyed
  450.       producing  it.   Please  don't  hesitate  to  send  suggestions for
  451.       improvements, bug reports etc.  Good luck.
  452.  
  453.            Nick Taylor
  454.  
  455.                 Text Technology
  456.  
  457. STOP PRESS:
  458.  
  459.       Graphics version of HyperShell almost ready - will be shipped to 
  460.       new customers from October 1992, along with further support
  461.       utilities for HyperShell.
  462.  
  463.